<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Slice</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu143.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu145.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRSLICE" ></A>Slice</H3>
		<A NAME="IDX715"></A><A NAME="IDX716"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATIAE">Import and Export</A>
<A NAME="IDX717"></A>
<P><STRONG>Function</STRONG>
<P>
Slices a multidimensional object.
<P><STRONG>Syntax</STRONG>
<P>
<PRE><STRONG>output</STRONG> = Slice(<STRONG>input, dimension, position</STRONG>);
</PRE>
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>input</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">object to be sliced
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>dimension</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">dimension to be eliminated
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>position</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">all
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">starting positions
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field or field series
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">sliced data
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module creates one or more "slices" of data from a
multidimensional object, each slice containing a subset
of input data.
It differs from the Slab module in reducing by one the dimensionality
of the object passed to <TT><STRONG>output</STRONG></TT>.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>input</STRONG></TT>
</B></TD><TD><P>specifies the data field to be sliced.
This field must have regular connections.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>dimension</STRONG></TT>
</B></TD><TD><P>specifies the dimension to be eliminated.
If <TT><STRONG>input</STRONG></TT> has <I>n</I> dimensions, the output
will have <I>n</I> &#45; 1.
These dimensions can be specified by number (from 0 to <I>n</I>
&#45; 1).
The first three can also be specified as <I>x</I>,
<I>y</I>, and <I>z</I>, respectively.
<P>
The default for this parameter is dimension 0 (zero).
<P><B>Notes: </B><OL>
<P><LI>The <TT><STRONG>dimension</STRONG></TT> number refers to the ordering of
positions in the "connections" component.
Thus, <I>x</I> corresponds to 0 only if the positions have been
specified as <I>x</I> varies slowest.
<P><LI>Slice can also be used on deformed grids, in which case the
connections do not align with any particular axis.
<P><LI>Transposing the positions (i.e., with Transpose) does <I>not</I>
change the order in the "connections" component.
</OL>
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>position</STRONG></TT>
</B></TD><TD><P>specifies the position from which the slice is generated.
<P>
If the specified value is a single value, the module creates a single
field sliced that position along the eliminated dimension.
<P>
If <TT><STRONG>position</STRONG></TT> is a list of integers, the module
creates a field series, sliced at each position in the list.
The series position of each series member is equal to the value of the
origin of that slice along the sliced axis.
<P>
If this parameter is not specified, the output is a series of slices
that begin at every grid position along
<TT><STRONG>dimension</STRONG></TT>.
</TD></TR></TABLE>
<P><B>Notes: </B><OL>
<P><LI>This module produces 2-dimensional data from 3-dimensional data.
To create a 2-dimensional slice in 3-dimensional space, use Slab.
<P><LI>Slice performs no interpolation, and only data with regular
connections can be sliced.
<P><LI>If the data are connection dependent, slicing is ill-defined
and the module returns an error.
</OL>
<P><STRONG>Components</STRONG>
<P>
All input components are propagated to the output.
<P><STRONG>Example Visual Program</STRONG>
<PRE>
WarpingPositions.net
</PRE>
<P><STRONG>See Also</STRONG>
<P>
&nbsp;<A HREF="refgu131.htm#HDRSELECT">Select</A>,
&nbsp;<A HREF="refgu143.htm#HDRSLAB">Slab</A>,
&nbsp;<A HREF="refgu146.htm#HDRSTACK">Stack</A>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
